home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 26.zip / BS1 part 26 / mediaphile disk 3.adf / ARexx / README_AREXX_TOAST < prev    next >
Text File  |  1991-06-07  |  3KB  |  66 lines
  1. ARexx notes for Video Toaster (05/23/91)
  2.  
  3. The Video Toaster's switcher program may be controlled through MediaPhile
  4. software using the ARexx interface. The ARexx script "toast_uni.rexx"
  5. will take a command line argument and send it to the switcher program.
  6. If the switcher program is not in memory, then the script will attempt to
  7. load it. Note that the script is currently set to find the program in the
  8. "work:toaster" directory.
  9.  
  10. Commands to the toaster must be entered exactly as they appear in the
  11. manual except that commas must be replaced with spaces. In addition, commands
  12. are CaSe SeNsItIvE. A complete list of commands may be found in Appendix J
  13. of the Video Toaster manual.
  14.  
  15. An example will help to explain the proper usage of this script. Let's
  16. take the AUTO function. Executing this command has the same effect as
  17. clicking on the AUTO gadget in the switcher program. It executes the currently
  18. selected toaster effect. To perform this function using our ARexx script,
  19. enter the CLI/shell command line:
  20.  
  21.         rx development/toast_uni AUTO
  22.  
  23. This assumes that you are in the directory "work:toaster," and that 
  24. "development" is an active subdirectory.
  25.  
  26. To execute the same command from within MediaProcessor, you could use the
  27. following EDL command:
  28.  
  29.         !Amiga:Execute(c:rx work:toaster/development/toast_uni AUTO)
  30.  
  31. This assumes that the ARexx RX program is in the logical "C:" directory and
  32. that the "toast_uni.rexx" script is located in the specified path.
  33.  
  34. If we wanted to load the frame store image number 001, we could use the
  35. following command line to accomplish this:
  36.  
  37.         rx development/toast_uni FMLD 1
  38.  
  39. This assumes that there is a framestore image number one and that it is in
  40. the currently active framestore directory. Note that the arguments "FMLD"
  41. and "1" are separated by a space, not a comma.
  42.  
  43. You may use the TOSW command to enter the switcher program from within
  44. MediaProcessor or from dos. To return to the workbench, either use the
  45. hotkey sequence CTRL-CTRL-ALT-ALT or select "exit" from the switcher
  46. preferences screen.
  47.  
  48. As with any of the other commands, you may use the "toast_uni.rexx" script
  49. to issue the QUIT command. Doing so has the same effect as the switcher's
  50. "exit" gadget descibed above.
  51.  
  52. Do not attempt to send an unrecognized command to the switcher using the
  53. "toast_uni.rexx" script as this may have adverse effects upon the system.
  54.  
  55. NOTES:
  56.  
  57. If you try to start the switcher from any directory other than the one the
  58. switcher program is located in, the Video Toaster software will respond with
  59. an error message. This may happen if, for example, you were in the directory
  60. "work:toaster/development" and issued the command "/switcher"
  61.  
  62. The program "ARexxWait" that is referenced in the "toast_uni.rexx" script
  63. is distributed by NewTek with the toaster software. It is used to give the
  64. switcher program time to load before ARexx attempts to address its message
  65. port.
  66.